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Good Technical 
Writing 




Presentation 




Timely information 



Clear purpose 



Factual information 
No plagiarism 



Supporting data 



Credit sources 




Useful information 



Appropriate for 
Readership 



Understandable 




Logical sections 
No bias 
Useful visual aides 



Reasonable grammar 

Good page / No jargon/acronyms 

Layout H Language \ 

I Skills ) 

Hierarchical ^\ /•* — No misspelling 

^ No punctuation errors 

Mixed sentence 
length 



headings 

Active voice 



Good 

Technical 

Writing 



Word Usage Appropriate for Readership 



Good technical requires an analysis of readers 
and proper choice of words and subject matter 
for the intended readership. 

In writing a patent, proposal, or technical report, 
an author must choose the content and wording 
properly . Example page 130 




Useful Information for Selected Readers 



The author must determine what the readers want. 
Authors also have the opportunity to decide whom to 
send information to. Only send documents to readers 
who will find value in the information in the 
document. 



If a reader asks, ''Why was this paper sent to me?'' 
you have sent it to the wrong person. 





Plagiarism: 

the act of presenting another' 
work or ideas as your own. 




No Plagiarism 

Plagiarism is the use of another^s work without 
permission , basically you cannot use any 
copyrighted material in a document, 
the effect of being caught in an act of plagiarism 
can be devastating. One stolen paragraph has 
ended otherwise distinguished careers. 



Plagiarism (take and use else's ideas) 
plagiarism checker 




Unique 



The software will tell you whether the line is unique or not 



Unique 



Unique 
Unique 



Unique 



In the end it will also show you the overall statistics of the post 



I mean it will show how many percentage of your article is unique 



After that it will publish the data 
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Factual Information/Supporting Data 




Putting a statement in a report constituting what a 

» i 

reader knows to be can cast the 



of the entire document in question. 





Most technical writers 

to convince readers to take action or pay attention 
to the message in a document. 

L 




Clear Purpose 

why the work is being done? 

A clear, concise statement of the purpose of any 
document is mandatory. State what you are 
trying to achieve with a document . Make the 
purpose and objective clear . Provide 
information on the importance of the work de- 
scribed in the document 



• Timely Documentation 

Reports should be completed when the work is done 
or when action is needed; proposals for funding 
must obviously meet any submission deadline. 

A more practical reason for timeliness is that you 
may lose data or forget important details if you do 
not write your report in a timely manner. ' 



Timeliness, timeline (difference) 



Sources of Information Credited 



P^H|||||||||p 




good technical document gives proper 
attribution when the work of others is cited to 
make a point or provide background information, 
sources of information should be cited in every 

I 

technical document 



• Understandable Statistics 
Page 137 

Statistics are becoming a more prominent part of 
corporate life. Writers need to realize that these 
terms are not known to everybody. A good repor 
should explain statistical terminology in wor 
understandable by the intended readers. 



Acronyms 

There is a tendency to use acronyms for everything. 

RULE 

Do not create your own acronyms; if you must use 

acronyms, define them. 

The best approach is just to eliminate acronyms . It is 
possible to write in understandable terms without 



acronyms. 



1^ Out Uoud 




Too Late = 



Falling Off the Chair Laughing = FOCL 





LGcrti 



Logical Sections 




A presentation needs to make sense . Technical 
writing. They look different and have different 
purposes, but all documents must be broken into ^ 
distinct parts, which are placed in a logical order 



in a clear fashion 




No Bias 

Bias is imposing a personal opinion or proclivity in 
your writing. This is to be avoided at all costs. 
Technical writing must be objective. State facts and for- 
mulate conclusions based on these facts. 
Bias is usually detected by a reader, and from that 
point on, credibility may be questioned 




Spo1 H. Talk about il 
Open your mind. Prevent it 



BIAS 




A technical document can be made interesting by 
including facts that: 

^ Are new to the reader 

* Demonstrate the importance of the work 

• Define the reader's stake in the results or 
conclusions 

Fig. 4.3 Page 144 Checklist for journal papers 




^^^^ 

to be 

INTERESTING, 

is to be 
INTERESTED. 




Specific 

a good technical document must contain specific 
statements rather than generalities and facts 
rather than opinions. Supporting data should be 
used to make points. 




Let's be "Specific" 



Glenn 
Research 
Center 



"Specific" means divided by "mass". 

Examples Specific Volume = Volume / Mass 

Specific Thmst = Thmst / Mass Flow 
Specific Fuel Consumption = Fuel Used / Pounds ofThmst 
Specific Impulse = Total Impulse / Weight of Propellant 
Specific Gravity = Weight of Object / Weight of water 



Why? 



Simplify problems - eliminate dependence on mass. 
Type of efficiency factor - easy comparison of two objects. 
Sizing of preliminary designs. 



• Report Mechanics 

general report mechanics — that is, the general 
methods that affect the overall appearance of a 
document. 




Hierarchical Headings 




The brain works faster than the eye, and 

headings provide a visual road map for what is to 

m 

come. A reader can fan through the pages of a 
long report and quickly assess the work by noting 
the section headings. The author of a technical 
document needs to use headings that define the 
hierarchy of contents within the document.M^BI 

1. Primary heading 

1.1 Secondary heading 

1.2 Another secondary heading 

1.2.1 Tertiary heading 

1.2.2 Another tertiary headin 

1.3 Another secondary heading 
Another primary heading 





Good Page Layout 

Reports should have an overall appearance that 
improves readability , A proper visual appearance 
increases readability, and the effective use of white 
space is an easy way to improve readability 




know 

you dont like it 

but its 

UIZ TIME 



Quiz 



1- list three different types of charts (use 
clear drawings). 

2- Define the three basic categories of 
illustrations. 

3- State five requirements of a good 
graph 



Every language has its rules. By definition, a 
language is a particular type of verbal 
communication. 

• No Jargon or Acronyms 

The overuse of acronyms or complex technical 
jargon, or ^^technobabble can also obscure 
meaning. Use words with concrete meaning and clear 
deHnitions, instead of complicating (or disguising) \ 
simple thoughts with unnecessary contortions of the 
English language. 



No Misspelling 

Spelling errors can destroy an otherwise perfect 
technical document. Readers do not object to the 
misspelled word, but rather that you did not 
proofread, and re-proofread to eliminate any 



Ten Words 

You Need To Stop 

Misspelling 



by The Oatmeal 



hccp://cheoatmeal.com 



Always leave a space here. 

Kt.-J'li-i'iibi'r. ifif/f's J kii Hj/spjLi' ill •luier .ipjiio. 



Alot is not a word. 



You don't write 

aliitle, jbunch, jcanuktupe, aporkchop 

So don't write atoc. . 



Definitely 

There is no A in "definitely." 

To help you remember, use this: 



Effect Affect Lose Loose 

W Not ti 



Most of the time effect is a noun and affect is a verb. 



Opposite of win 



Ifyou're unsure, try 
substituting a different 
verb and see if it works. 



{ 



As a child, he was affected 
by his parents. 
As a child, he was offocted 
by his parents. 



If you put an A in 
"definitely/' then you're 
definitely an A- hole. 



f Averb works hcresoyou 
^ should use "affected." 



It's 



This is a contraction for 
ft is or ft has. 

If yuucan leplKe Ir^i ui1<h Jt liur Ithdm, 
(h<n UM Jr'tin your w 



For example: 



Its 



This is Indicating 
possession. 

L>H (h li when om 
thinf trt/ns inoOur. 

For example: 




ed I 

earen g 



Pretend the extra ( 
hemorrhoid on the v 

Hemorrhoids are never ti 



I've ^ tiye 



Weather Whether 



Ym ate 

but he sm\^ d»1j sf 

Pad! 



Snow, rain, sunshine, typhoons. 
All that crap. 



Their They're There 



I'm tint tUf>, I imM fHpef>> happ^ MrOiine* 




Whetheris used In Ehls way: 
Your correct usage of this word will 
determine whether or lUH I kick 
you in the hemorrhoids. 



Nothing gets a point across like 
solid kick to the hemmles. 



kea \ 

: A 



Their is possessive, 
meaning it owns 
something. 




They're is a 
contraction for 
"they are." 

tM ^« Mnle« the;) ^ that 



Then Than 



In this case, their is referring to 
the neighbors who own a cow. 



is used for time. 

I First { stole d pdfjrfd hejf. ihe/i 
e drank malt lititjor together. 



The Hqucnceof 
«:tjnn« Indiutn time: 
firtt »l:«lin]| [he puhU. 
.an4ili«n di^nklne 




is used for comparison. 

I 'm much better at hoidingmy 
tiquor than a panda bear. 




There refers to a 
place or idea. 

this form if yiMi'rr unsure. 

fkn dkeit jutt 
HMfUi out »f W 



Weird 

Remember it like this: 



Not wierd 
♦ 

Every time you spell it this way. 
a dolphin gets run over by a jet ski. 



i 



We ... ir ... d - 
We ... are<lr> .... dangerous (d> 
to those dumb, dirty dolphins. 




In this case, che^^re 
means "they are.' 



in this case, there is 
referring to a location. 



ptntU'-i drinklnK Atrillcy 
with ynur ouni : m you 
should use 'thin.' 




It can also refer to 
something more abstract: 

There Jre ntjny reasons to distripline a cow. 
For surters, a cow who ejts rancid casseroie 
Will liter become a host for alien parasites. 



Your You're 

, — * » — , 

I These both use the same rules as "their" and "they're." I 



Your is possessive. 
In other words, you own something. 

Vourneu'babya/ie/i loves to cuddle, 
but he keeps crapping in your 
refrigerator at night. 

f This is referring to your alien 1 
I and your refrigerator. J 



Vou'reis a contraction 
of "you are." 

You're definitely cleaning out the fridge ' 
tomorrow morning, assuming that little^ 
bea.%tC3n'tkeephh bowel^i in check. 



Th is translates to "you are 
definitely cleanings" 





» No Punctuation Errors 

Errors in punctuation are in the same category as 
misspelling. Technical documents require 
technical accuracy, and proper punctuation is no 
less important than the placement of a decimal 
point in a stress calculation. 




Pttucliiaiioii 





Use a period at the end of 
I a declarative sentence 
1 and in abbreviations. 




uestion 
Hark 



Use a question 
mark after an 
interrogative 



QuofatloQ 
narKs 



Use quotation marks for 
direct quotations. 



Use a comma to separate 

items in a series, 
to setoff an appositive, 
or before tlie conjunction 
In a compound sentence. 



9 



: Colon 



Use a colon to mtroduce a list and 
before a final clause that explains 
something in the sentence. 




Use an apostrophe in 
contractions and to 
indicate possession. 



■ Use a hyphen to join v^ords 
I serving as a single adjective 
ft before a noun, in number words. 
Bnd to divide words into syllables. 



parentlieses 



Use parenthese 
around extra 
non-essential 
information that 
is too important 
to omft. 



Point 



an exclamation 
to show strong 
on or to give a command. 



9 



Use a semicolon to 
jjoin two independent 
clauses that are not 
connected with a 
coordinate conjunction. 



• Mixed Sentence Length 

Proper technical writing requires sentences that 
are neither too short nor too long. Long sentences 
are difficult to read, but short sentences present a 
choppy type of writing. 

Avoid long sentences that present several facts 




Written in the Active Voice 




4 



professional writers and English instructors believe 
that readers 

The author is perceived to be more assured of 
himself or herself when writing in the active voice.^ 
Therefore, authors should try to use verbs that 
connote action in the present tense. 

PAGE 154 



Passive verbs are longwinded, ambiguous and dull. 
Active verbs make your writing simpler, less awkward, 
clearer and more precise. 




The QMS Magicolor 2 Printer is equipped with two 
interfaces, one is known as the parallel interface, the other is 
known as the Ethernet interface. Whatever interface 
connection is needed, you will find that MS Windows 98 has 
already been preinstalled and your software applications are 
based on this platform. 



The QMS Magicolor 2 Printer has Parallel and Ethernet 
interfaces. Whatever interface you need, you will find your 
software applications will work on the preinstalled MS 
Windows 98. 



Reasonable Grammar 

Poor grammar can affect your credibility as a 
technical person. Readers may question why an 
author did not have a document proofread 
before sending it out. One of the most common 
grammar errors in English writing is disagree- 
ment of verb and noun in a sentence. 
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1 vwAv.tayxiongsheng.corn 
I Twitter @tayxiongsheng 




English Grammar 



• Concision 

A concise document contains no more words than 
necessary. Concision is an important attribute of 
technical writing because readers want to be 
informed in the fewest possible word. Eliminat 
any unnecessary words, phrases, or sentences. 



Omit needless words and information 



It is very important that every single generated error message, no 
matter how minor of an error, be carefully recorded by the 
Foobar system in the audit file for future consideration by the 
maintenance engineers who will try to improve the system's 
reliability. 

It is very important that every single generated error message, no 
matter how minor of an error, be carefully recorded by the 
Foobar system in the audit file for future consideration by the 
maintenance engineers who will try to improve the system's 
reliability. 





students Report 



^ Page 160 



Presenter 



Define and Explain each of 
the Important Terms. 



WARNINGS 




Always put on salMy 

0a aatM to protect your 
ey«s. 




H&*m pull trtggsr •vtci 
you Mnk It Is smpiy ot 
maguins. It is dangsrous, 
thrs msytes psaxs 
rsmsin In t«s maQulns. 



Novor point the gun at 
anyone or any animal, 
though the magazine ts 
paoet empty. 




Navar put your tir>gar on 
tha trlggar uniata you ara 
praparad to lira. 




Navar shoot as foMrtg. 
always look balor a shoot, 
tha caralaas usa may 
cauaa Injura and ba 
punishad. 




Novor iooK into tha bartral 
or tha gun. 




It 

■ A i aaya fc a tp s tha gun 

I to sate direction. 



Do rxM eanyout m 

piMIc place, put Into 
the bag tor oarryirig. 



Mover dissembia tha 
gun by yourselt wAwch 
mn cause the troubie 
ar>d dangerous. 



Kaap out Of lha IMC*) ot 

ctiAdrBfiL 



